home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / cpumt10a.zip / CPUMETER.HLP (.txt) < prev    next >
OS/2 Help File  |  1996-06-21  |  27KB  |  376 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. About Cpumeter ΓòÉΓòÉΓòÉ
  3.  
  4. Welcome to CPUMeter, Version 1.0a 
  5.  
  6. I am proud to present the first public version of CPUMeter. This program is 
  7. SHAREWARE, you are allowed to distribute the zipfile cpum*.zip. Do NOT 
  8. redistribute any part of this zipfile. After a trial period of 4 weeks, you 
  9. have to register if you want to use the program any further. Otherwise, you 
  10. must remove it from your computer. 
  11.  
  12. CPUMeter is an enhanced CPU-usage meter, similar to "PULSE.EXE". Unlike other 
  13. CPU-meters, it does not use a counting loop to determine the CPU-load. It uses 
  14. the DosQProcStat API-call. This reduces CPU-load and CPU power-consumption and 
  15. gives the possibility to show infos about CPU-hogging processes. 
  16.  
  17. This program is SHAREWARE. That means you are allowed to copy and distribute 
  18. the original-archive (cpum*.zip) and you are allowed to test the program for 
  19. two weeks. After that time, you MUST register it or remove the program from 
  20. your PC(s). 
  21.  
  22. To register, send me 
  23.  
  24.      Money $$$$  ;-) 
  25.  
  26.         -  either DM 20,- cash or as negotiable "EUROCHECK" 
  27.  
  28.         -  or   US$20,- cash or as negotiable "EUROCHECK" 
  29.  
  30.      Your postal-adress, so i will know where to send your registration-key. 
  31.  
  32.  My adress is: 
  33.  
  34.     Christof Pastors 
  35.     Luitpoldstr. 12 
  36.     91054 Erlangen 
  37.  
  38.     Germany 
  39.  
  40.  I am also open to comments and discussion about my program, any constructive 
  41.  comment will be appreciated. If you want to contact me via email: 
  42.     pastors@eev.e-technik.uni-erlangen.de 
  43.  
  44.  The newest version of CPUMeter can be found on the regular ShareWare-servers 
  45.  (like Hobbes) or (the very newest) at: 
  46.     http://eev11.e-technik.uni-erlangen.de/cpumeter.html 
  47.  
  48.  And here the legal stuff: 
  49.  
  50.   CPUMeter is Copyright (c) 1996, Christof Pastors 
  51.  
  52.  This program is provided "as is" and gives you a chance to try the product for 
  53.  two weeks. After that time, you MUST register it or remove the program from 
  54.  your PC(s). I will give NO kind of SUPPORT to unregistered users (though i am 
  55.  open for comments and constructive crticism). I tried to find as many bugs as 
  56.  possible, but i am IN NO WAY RELIABLE FOR INDIRECT OR  SIMILAR  DAMAGES, 
  57.  INCLUDING  ANY LOST PROFITS OR LOST DATA ARISING OUT OF  THE  USE OR 
  58.  INABILITY TO USE THE SOFTWARE OR ANY DATA SUPPLIED . 
  59.  
  60.  
  61. ΓòÉΓòÉΓòÉ 2. Installation ΓòÉΓòÉΓòÉ
  62.  
  63. Simply unzip the zipped files in a single directory. Then create a new 
  64. program-object by starting cpu_inst.cmd or by dragging and customizing an 
  65. object from the program-template in your templates-folder.  READY. 
  66.  
  67. CPUMeter does not register a DLL nor does it create an entry in the ini-files 
  68. of OS/2, i don't like programs modifying system-files! 
  69.  
  70. NEW! Accurate results with High-Resolution-Timer! 
  71. To exploit all capabilities of CPUMeter, you can use the 
  72. "High-Resolution-Timer". For this, you need two new drivers from IBM: 
  73. CLOCK01.SYS and TIMER0.SYS. If you have one of those rare microchannel-PCs, you 
  74. need the CLOCK02.SYS driver instead of clock01. With those drivers, the problem 
  75. is fixed that CPUMeter shows to much CPU-load when an application is waked very 
  76. often (for example to handle mouse-movement messages). BUT BE WARNED: 
  77. Enabling this option can cause problems 
  78.  
  79.      DOS-programs that use the same hardware-timer will hang. This is propably 
  80.       the case with many DOS-Games. 
  81.  
  82.      WINDOWS-sessions may hang when starting or they can show bad response to 
  83.       mouse-input. 
  84.  
  85.      Seamless WINOS2-sessions may even block the OS/2 desktop when they hang 
  86.       on startup. 
  87.  If you have problems with a DOS-program that needs the same PC-hardware-timer, 
  88.  go to the settings-Notebook of CPUMeter and disable the use of HRTimer. In 
  89.  rare cases, you should also exit CPUMeter after this step to free the 
  90.  Hardware-timer. 
  91.  
  92.  How YOU can get these drivers: 
  93.  
  94.      They will be part of MERLIN, the next version of OS2, 
  95.  
  96.      I added the MMPM_MPU.ZIP archive that comes from IBM to the CPUMeter 
  97.       archive. You can find the needed drivers in there. 
  98.  
  99.      They are part of the DEVCON 9/10 "Developer's Toolkit for OS/2 Warp" ( 
  100.       see BETA-section there) 
  101.  
  102.      They are part of the new Real-Time-Midi package developed by IBM. 
  103.  
  104.      And they can be found per ftp at the HOBBES-Shareware archive ( 
  105.       MMPM_MPU.ZIP). 
  106.  
  107.  How to install the new drivers: 
  108.  If you don't use ( or need ) the according Multimedia-Setup "MINSTALL.EXE", 
  109.  which brings you full MPU-401 multimedia support, install them "by hand": 
  110.  
  111.      Make a backup copy of the old clock01.sys in the \os2\boot\ directory. 
  112.  
  113.      Copy the new clock01.sys and timer0.sys in this directory. 
  114.  
  115.      Add the statement "BASEDEV=TIMER0.SYS" to your config.sys. 
  116.  
  117.      Reboot. 
  118.  If CPUMeter can't open the new timer on program-startup, it will use the 
  119.  (inaccurate) standard-timer. 
  120.  
  121.  
  122. ΓòÉΓòÉΓòÉ 3. Technical Details ΓòÉΓòÉΓòÉ
  123.  
  124. How does it work? What's so special with this "pulse"-like app? 
  125.  
  126. I never liked the way most PULSE-like cpumeters work: They create an 
  127. idle-priority thread that executes a infinite counting loop which hogs the CPU 
  128. as soon as it is idle. This way the CPU will never get really idle.... 
  129.  
  130. Instead i wrote a REAL CPUMeter, that queries the OS/2 kernel every second, how 
  131. much cputime all processes have consumed and then displays the result. After 
  132. 10msec, the CPU is idle again. There is a "documented" undocumented API-call 
  133. (DosQueryProcStat) that gives all informations one would need: Which thread of 
  134. which process has consumed how much cputime and much more infos. If you are 
  135. curious, take a look at pstat.exe in your \os2\ directory. Simply spoken, this 
  136. program does a formatted output of the mentioned API-call. This program and the 
  137. wonderful tool called "watchcat" exploit this API-call and gave me the idea ... 
  138.  
  139. Basically, CPUMeter queries the process-statistics every second and sums up the 
  140. cputime consumed by all threads. This and the name of the most cpu-consuming 
  141. process is displayed. There are some advantages and some disadvantages of this 
  142. proceeding: 
  143.  
  144. Advantages: 
  145.  
  146.      It is easy to determine the process who actually hogs the CPU. 
  147.  
  148.      There is no Idle-Tread counting and counting. This means: 
  149.  
  150.         -  The CPU is really idle when nothing else is to do. The power 
  151.            consumption of the CPU is reduced dramatically. As my favorite 
  152.            german computer-magazine "Ct" showed, OS/2 and LINUX "HALT" the CPU 
  153.            when the kernel is idle between the (timer-) interrupts and nothing 
  154.            else is to do. On my P60, the power consumed by the CPU goes down 
  155.            from 12W to 4W. This could be interesting for people who like 
  156.            overclocking their CPUs ;-) . Or for the people who own a NOTEBOOK 
  157.            and wonder, why the battery goes low when PULSE is running... 
  158.  
  159.         -  Other Idle-Priority threads like the thumbnail-creator in PMVIEW.EXE 
  160.            or the idle-priority worker-thread in FM/2 can do their work without 
  161.            having to share the CPU with PULSE and its "useful" counting-loop. 
  162.  
  163.  Disadvantages: 
  164.  
  165.      When threads are created and finished in a very short time (< 1sec), 
  166.       CPUMeter will not always see them and therefore report a lower cpu-load. 
  167.  
  168.       Note: 
  169.       The next problem is fixed if you have the new High-Resolution-Timer from 
  170.       IBM installed! See  installation for details. 
  171.  
  172.      When a process is waked very often (hundred times a second and faster), 
  173.       the kernel counts to much cputime for this thread. This can be the case 
  174.       for a  DOS-BOX that polls the keyboard or for a window, that gets a lot 
  175.       of messages when you move the mouse over its window-area. Sorry, this is 
  176.       a restriction of the kernel, not my fault. 
  177.  
  178.  
  179. ΓòÉΓòÉΓòÉ 4. CPUMeter - Application Help ΓòÉΓòÉΓòÉ
  180.  
  181. CPUMeter's  User-Interface consists of: 
  182.  
  183.  Main Window,        this is shown on startup. 
  184.  
  185.  PopUpMenu,          this is shown after a Right-Mousebutton-Click on the 
  186.                      Main-Window. 
  187.  
  188.  Process-List,